Level System

CocoGuild features a comprehensive guild leveling system that rewards active guilds with increased limits and custom rewards.

Configuration

plugins/CocoGuild/levels-config.yml

level-system:
  enabled: true
  xp-mode: "commands"
  max-level: 100
  starting-level: 1
  formula: "custom" # linear, exponential, custom

  # For linear formula
  xp-per-level: 1000

  # For exponential formula
  exponential-base: 1.5

  # Notification settings
  xp-notification: true
  xp-notification-threshold: 5

XP Progress Bar

Customize how the XP progress bar appears:

plugins/CocoGuild/levels-config.yml

xp-progress-bar:
  enabled: true
  length: 20
  filled-char: "█"
  empty-char: "░"
  filled-color: "&#00FF00"
  empty-color: "&7"
  brackets: true
  bracket-color: "&8"
  show-percentage: true
  percentage-color: "&e"

XP Sources

Guilds can earn XP from various activities:

Source	Default XP
Player Kill	10 XP
Mob Kill	1 XP (with multipliers)
Block Break	0.1 XP (with multipliers)
Block Place	0.1 XP

Mob XP Multipliers

Different mobs give different amounts of XP:

Mob	Multiplier
🐉 Ender Dragon	100x
💀 Wither	50x
🏛️ Warden	20x
🐟 Elder Guardian	10x
🦹 Ravager	5x
🧙 Evoker	3x
🔥 Blaze	2x
🧟 Zombie/Skeleton	1x

Block XP Multipliers

Mining valuable blocks gives bonus XP:

Block	Multiplier
🔲 Spawner	50x
⬛ Ancient Debris	20x
💎 Deepslate Emerald Ore	18x
💚 Emerald Ore	15x
💠 Deepslate Diamond Ore	12x
💎 Diamond Ore	10x
🟡 Gold Ore	5x

Level Rewards

Configure rewards for reaching specific levels:

plugins/CocoGuild/levels-config.yml

rewards:
  enabled: true

  levels:
    5:
      max-members: 15
      max-allies: 3
      commands:
        - "eco give %guild_owner% 1000"
        - "msg %guild_owner% &aYour guild reached level 5!"

    10:
      max-members: 20
      max-allies: 5
      commands:
        - "eco give %guild_owner% 5000"
        - "give %guild_owner% diamond 5"

    50:
      max-members: 60
      max-allies: 12
      commands:
        - "eco give %guild_owner% 75000"
        - "give %guild_owner% netherite_block 1"
        - "broadcast &6&lGuild %guild_name% reached level 50!"

    100:
      max-members: 100
      max-allies: 20
      commands:
        - "eco give %guild_owner% 500000"
        - "broadcast &6&l&k!!&r &e&lGuild %guild_name% reached MAX LEVEL!"

Level Names

Customize the display name for each level range:

plugins/CocoGuild/levels-config.yml

level-names:
  1-4: "Novice"
  5-9: "Apprentice"
  10-19: "Journeyman"
  20-29: "Adept"
  30-39: "Expert"
  40-49: "Master"
  50-59: "Grandmaster"
  60-69: "Champion"
  70-79: "Hero"
  80-89: "Legend"
  90-99: "Mythic"
  100: "Eternal"

Level Up/Down Settings

plugins/CocoGuild/levels-config.yml

level-up:
  broadcast: true
  fireworks: true
  sound: "ENTITY_PLAYER_LEVELUP"
  title:
    enabled: true
    title: "&#00FF07LEVEL UP!"
    subtitle: "&fYour guild reached level &#00FF07{level}&f!"

level-down:
  enabled: false
  on-member-leave: -100
  on-member-kick: -50

Anti-Abuse Settings

Prevent XP farming exploits:

plugins/CocoGuild/levels-config.yml

anti-abuse:
  prevent-block-abuse: true
  track-placed-blocks: true
  cooldown-between-same-action: 0 # seconds

blacklisted-blocks:
  - BEDROCK
  - BARRIER
  - WHEAT
  - CARROTS
  - POTATOES
  - BEETROOTS
  - SUGAR_CANE
  - CACTUS
  # ... and more farmable blocks

Admin XP Commands

Command	Description
/guild admin level xp set <guild> <amount>	Set a guild's XP to a specific value
/guild admin level xp give <guild> <amount>	Add XP to a guild
/guild admin level xp remove <guild> <amount>	Remove XP from a guild